home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / misc / converter / !Converter / !Help next >
Encoding:
Text File  |  1996-11-09  |  18.7 KB  |  525 lines

  1.  
  2.  
  3.                  Converter                      © Copyright 1993 Ian Palmer
  4.                  =========
  5.  
  6.  
  7.  
  8. Converter is an application that allows easy conversion between different
  9. systems of measurement. It can handle complex conversions which include
  10. combinations of units, for example you can convert meters per second to miles
  11. per hour, or even Newtons per meter to poundals per furlong.
  12.  
  13. A full list of known units is given at the end of this file, but the general
  14. areas covered are length, area, volume, mass, time, force, energy, pressure,
  15. surface tension, viscosity, frequency and temperature.
  16.  
  17.  
  18.  
  19. Introduction
  20. ------------
  21.  
  22. Converter, when run, installs itself on the iconbar. Pressing SELECT on the
  23. icon brings up the main (weights and measures) converter window, whilst
  24. pressing ADJUST brings up the temperature converter. MENU brings up the main
  25. menu which contains the usual 'Info' and 'Quit' options.
  26.  
  27.  
  28.  
  29. The Temperature Converter
  30. -------------------------
  31.  
  32. This converter is designed to allow simply conversion between four different
  33. temperature scales, degrees centigrade (or Celsius as it is sometimes, but
  34. incorrectly, known), Kelvin, degrees Fahrenheit, and finally degrees Reaumur.
  35.  
  36. When you bring up the temperature conversion window it looks a bit like :
  37.  
  38.  
  39.         -----------------------------------------
  40.        |          _______           ________     |
  41.        |  From : |_______|    To : |________|    |
  42.        |                                         |
  43.        |   <> °C                        <> °C    |
  44.        |                                         |
  45.        |   <> °F                        <> °F    |
  46.        |                                         |
  47.        |   <>  K                        <>  K    |
  48.        |                   ----                  |
  49.        |   <> °R          | OK |        <> °R    |
  50.        |                   ----                  |
  51.        |_________________________________________|
  52.  
  53.  
  54. To perform a conversion first select the relevant temperature units for the
  55. conversion, and then enter the start value into the writable icon next to the
  56. word 'From :'. Then by pressing RETURN or pressing the 'OK' icon the result
  57. of the conversion will appear in the icon next to the word 'To :'.
  58.  
  59. So, for example, say you wanted to convert 10°C to °F. You'd first select the
  60. '°C' radio icon on the left hand side of the window, and the '°F' icon on the
  61. right hand side of the window. Then entering '10' into the writable icon and
  62. pressing RETURN will make the value '50' appear in the result icon.
  63.  
  64.  
  65.  
  66. The Weights and Measures Converter
  67. ----------------------------------
  68.  
  69. This converter is much more powerful than the temperature converter described
  70. above. When you bring up the window it looks something like :
  71.  
  72.  
  73.  
  74.        ------------------------------------------------------------------
  75.       |                                                                  |
  76.       |     From                                                         |
  77.       |    ___________________                     __________________    |
  78.       |   |                   |          Value :  |                  |   |
  79.       |   |___________________|                   |__________________|   |
  80.       |                                                                  |
  81.       |  =======================                                         |
  82.       |                                                                  |
  83.       |    ___________________                                           |
  84.       |   |                   |                                          |
  85.       |   |___________________|     Dimensions :  M     L    T    K      |
  86.       |                                                                  |
  87.       |                                                                  |
  88.       |     To                                                           |
  89.       |    ___________________                     __________________    |
  90.       |   |                   |          Value :  |                  |   |
  91.       |   |___________________|                   |__________________|   |
  92.       |                                                                  |
  93.       |  =======================                                         |
  94.       |                                                                  |
  95.       |    ___________________                                           |
  96.       |   |                   |                                          |
  97.       |   |___________________|     Dimensions :  M     L    T    K      |
  98.       |                                                                  |
  99.       |                          __     _     _           _____    ____  |
  100.       | <> Normal               /Kg\   |=|   /|\    ||   |Clear|  | OK | |
  101.       |                         ----   |-|   \_/    ()    -----    ----  |
  102.       | <> Engineering                                                   |
  103.       |__________________________________________________________________|
  104.  
  105.  
  106. Now this takes a little explaining. Think of the window as being separated
  107. into three parts, the top part describes the 'from' part of the conversion,
  108. ie. what you wish to convert from. The middle part describes the 'to' part of
  109. the conversion and is similar in layout to the 'from' part. The bottom
  110. section of the window is general control over the conversion and also
  111. displays some information about the conversion (more on that later).
  112.  
  113. Now both the 'from' and 'to' sections are further divided into three
  114. sections, on the left are two writable icons separated by a black line. These
  115. icons are for entering the units for the conversion. The next subsection is
  116. the 'Value' section, on the 'from' section this is a writable icon for you to
  117. enter the value to be used in the conversion, in the 'to' section this icon
  118. is filled in by the program. The final subsection details the 'dimensions' of
  119. the expression you have entered into the icons in the first subsection (more
  120. on this later).
  121.  
  122.  
  123. Let's have a simple example. Say you wanted to convert 10 miles into
  124. kilometers. What you would need to do is enter 'mile' into the top left icon
  125. in the 'from' section (leave the lower left icon in this section blank), then
  126. enter 'km' into the top left icon in the 'to' section (again leave the lower
  127. left icon blank), and finally enter the value '10' into the Value icon in the
  128. 'from' section. Pressing RETURN at this stage (or selecting the 'OK' icon in
  129. the bottom right of the window) will make the program perform the conversion,
  130. the value '16.09344' will appear in the value icon in the 'to' section.
  131.  
  132. NOTE: When entering the units 'mile' and 'km' make sure these are entered in
  133. lower case.
  134.  
  135.  
  136. So what are the icons that we left blank in the above example for? Well they
  137. are for more complex conversions to be performed. Think of the two icons on
  138. the left of the 'from' section as a fraction, the top icon is the numerator,
  139. the lower icon the denominator. The use of this is shown in the following
  140. example :
  141.  
  142. Say we wanted to convert 50 miles per hour to kilometers per hour. Leave the
  143. 'mile' and 'km' entered in the first example as they are, but enter 'hour'
  144. in bottom left icons in both the 'from' and 'to' sections. Now replace the
  145. '10' in the value icon in the 'from' section with '50' and press RETURN or
  146. select the OK icon. The value '80.46720001' will appear as the result.
  147.  
  148.  
  149. In fact the denominator icons aren't strictly necessary. You could place all
  150. the units on the numerator line. For example the last example could be
  151. performed by entering 'mile hour-1' into the numerator icon for the 'from'
  152. section (denominator icon blank), and 'km hour-1' into the numerator icon in
  153. the 'to' section (again denominator blank). This is because any value placed
  154. directly after a unit (no space in between) is taken as the power of that
  155. unit, thus cm2 is equivalent to 'centimetres squared', etc.
  156.  
  157.  
  158. Please note that in the above there is a space between the word 'mile' and
  159. 'hour-1'. This space is necessary and must be present between all units
  160. entered into these icons. So for example you could enter 'meters per second'
  161. as 'm s-1' but NOT 'ms-1' (as this would be taken as milliseconds to the power
  162. of -1).
  163.  
  164.  
  165. Now, what are these 'dimensions' bits all about. You may have noticed that
  166. when you perform a conversion, numbers appear in the 'Dimensions' subsection
  167. of both the 'from' and 'to' sections. It is not strictly necessary to
  168. understand these to be able to use the program, they only give you
  169. information. The dimensions comprise of MASS (shown as M) LENGTH (shown as
  170. L), TIME (shown as T) and TEMPERATURE (shown as K). Each of these is given a
  171. value relating to the total power in the expression. 
  172.  
  173. Thus let's take the case of 'miles per hour'. This, as has been stated, can
  174. be written as 'mile hour-1'. 'Miles' is a unit of length, and is at a power
  175. of 1, where as 'hour' is a unit of time and is at a power or -1. Thus adding
  176. this together gives up a total mass 'power' (or dimension) of 0, a total
  177. length 'power' of 1, a total time 'power' of -1 and a total temperature
  178. 'power' of 0. Thus the 'Dimensions' subsection would appear as :
  179.  
  180.     0   1   -1  0
  181.    M   L   T   K
  182.  
  183. You may ask "Is this useful?". Well the simple answer is "Yes!". This is
  184. because for any conversion to be valid the dimensions of the 'from'
  185. expression must be the same as the dimensions of the 'to' expression. 
  186.  
  187. It is worth noting that Converter will perform conversions in the case where
  188. the two sets of dimensions are different, producing a result. This result,
  189. however, will be meaningless.
  190.  
  191. Converter also displays the results of the comparison of the dimensions in
  192. the bottom section of the window. In this section are 4 pictures, a kilogram
  193. weight (representing the 'mass' dimension), a ruler (representing the
  194. 'length' dimension), a clock (representing the 'time' dimension) and a
  195. thermometer (representing the 'temperature' dimension). After a conversion if
  196. any of these have a big red cross through them then there is an in-balance in
  197. that dimension, and the conversion is thus invalid. If none of the symbols
  198. have crosses through them then the conversion was valid.
  199.  
  200.  
  201. To demonstrate this, let's perform an invalid conversion. Let's try to
  202. convert 10 kilograms into inches. Enter 'kg' into the top left icon in the
  203. 'from' section, and 'inch' into the top left icon in the 'to' section. Then
  204. enter the value '10' into the value icon in the 'from' section and press
  205. RETURN (or select the OK icon).
  206.  
  207. The conversion will appear to have worked, you get the value '393700.7875' in
  208. the result icon, but you will notice that both the weight and ruler icons
  209. have crosses through them, indicating that the conversion was in fact
  210. invalid.
  211.  
  212. Finally, there is one area not touched upon. In the bottom section there are
  213. two options labelled 'Normal' and 'Engineering'. These dictate how the result
  214. should be displayed after a conversion. It should currently be on 'Normal' as
  215. this is the default. Selecting the 'Engineering' option and pressing OK
  216. (assuming you still have everything set up as in the last example) will make
  217. the result change from '393700.7875' to '393.70007874E3'. This option has
  218. made the result be displayed in engineering notation (as with the 'ENG'
  219. button on most modern calculators). Basically this forces the value to be
  220. displayed as a number between 1 and 1000 times 10 to the power of a multiple
  221. of 3. 
  222.  
  223.  
  224.  
  225. Entering units by mouse
  226. -----------------------
  227.  
  228. To make life even easier you can enter the units for conversion using only the
  229. mouse. Pressing MENU when the mouse pointer is over the weights and measures
  230. converter beings up a menu. This menu contains, through a series of submenus,
  231. a list of the units known to Converter as well as the common prefixes for
  232. metric units (centi, milli, etc.) and the most commonly used powers (2,3,-1,-2
  233. and -3). The Menu looks something like this :
  234.  
  235.       ______________
  236.      |     Units    |
  237.      |==============|
  238.      | Prefix      >|
  239.      |--------------|
  240.      | Length      >|
  241.      | Area        >|
  242.      | Volume      >|
  243.      | Mass        >|
  244.      | Time        >|
  245.      | Force       >|
  246.      | Pressure    >|
  247.      | Energy      >|
  248.      | Power       >|
  249.      | Viscosity   >|
  250.      | Temperature >|
  251.      |--------------|
  252.      | Power       >|
  253.      |______________|
  254.  
  255.  
  256. Each entry leads to submenu containing the selectable items. Note that the last
  257. entry in the menu 'Power' is different to the 'Power' entry three above it.
  258. The last entry refers to raising units to powers (eg. 2, 3, etc.) where as the
  259. other entry refers to units of power.
  260.  
  261. Selecting any of the items in the submenus will insert that item at the end of
  262. the icon (in the converter window) containing the caret. Entering a prefix item
  263. will enter that item followed by a '-' (indicating that something else needs
  264. to be selected) which will be removed when you select the next thing to be
  265. inserted (eg. meter, gram, etc.).
  266.  
  267. The order that you enter parts of a unit is the order given in the menu 
  268. structure, ie. you insert a prefix (if appropriate), then the unit, then any
  269. power that you wish to raise the unit to.
  270.  
  271.  
  272.  
  273. Units Known by the Weights and Measures Converter
  274. -------------------------------------------------
  275.  
  276. Below is a list of all units known by the weights and measures converter.
  277. They basically cover the S.I. (metric) units, the cgs units, and the old
  278. British Imperial units.
  279.  
  280. With the S.I. units for length, mass, etc. the following can be prefixed :
  281.  
  282.      Prefix        Meaning
  283.      ------        -------
  284.  
  285.        E           exe         1E18
  286.        P           peta        1E15
  287.        T           tera        1E12
  288.        G           giga        1E9
  289.        M           mega        1E6
  290.        hk          hectokilo   1E5
  291.        ma          myria       1E4
  292.        k           kilo        1E3
  293.        h or H      hecto       1E2
  294.        da or D     deka        1E1
  295.  
  296.        d           deci        1E-1
  297.        c           centi       1E-2
  298.        m           milli       1E-3
  299.        dm          decimilli   1E-4
  300.        cm          centimilli  1E-5
  301.        u           micro       1E-6
  302.        n           nano        1E-9
  303.        p           pico        1E-12
  304.        f           femto       1E-15
  305.        a           atto        1E-18
  306.  
  307.  
  308. The following are known units, some have alternative versions where either
  309. can be used, anything in brackets is simply a fuller version of a unit where
  310. you should use the abbreviation not the term within the brackets. The units
  311. are divided up into related sections. Those marked with a * are the units
  312. which can have the above prefixes added to them.
  313.  
  314.  
  315. Length
  316. ------
  317.  
  318.   *   m              (meter)
  319.       micron         (1E-6 m, or 1 um)
  320.       angstrom       (1E-10 m)
  321.       fermi          (1E-15 m, or 1 fm)
  322.       inch in
  323.       foot feet ft
  324.       yard yd
  325.       fathom
  326.       link
  327.       chain
  328.       furlong
  329.       mile mi
  330.       nmile nmi      (nautical mile (British 6080ft))
  331.       anmile anmi    (nautical mile (Admiralty & International 1852m))
  332.       rod
  333.       cable
  334.       hand
  335.       span
  336.       knot
  337.       pace
  338.       point
  339.  
  340. Area            Note: Area mostly represented by a length unit squared
  341. ----
  342.  
  343.       are
  344.       hectare
  345.       barn
  346.       acre
  347.  
  348.  
  349. Volume          Note: Volume often represented by a length unit cubed 
  350. ------
  351.       
  352.   *   l             (litre)
  353.       fl.oz         (fluid ounce)
  354.       pint pt
  355.       quart
  356.       gallon
  357.       bushel
  358.       peck
  359.       teaspoon tsp
  360.       tablespoon tbsp
  361.       cup
  362.       cord
  363.       gill
  364.  
  365.       
  366.  
  367. Mass
  368. ----
  369.  
  370.   *   g             (gram)
  371.       tonne         (1E6 g)
  372.       ounce oz
  373.       pound lb
  374.       stone
  375.       quarter
  376.       hundredweight cwt
  377.       ton
  378.       quintal
  379.       dram
  380.       grain
  381.  
  382.  
  383. Time
  384. ----
  385.  
  386.   *   s sec         (second)
  387.       min minute
  388.       hour hr H h
  389.       day
  390.   *   Hz            (Hertz, or s-1)
  391.  
  392.  
  393. Force
  394. -----
  395.  
  396.   *   N             (Newton)
  397.       dyne dyn
  398.       poundal
  399.       lbf           (weight of 1 lb mass)
  400.  
  401.  
  402. Pressure      
  403. --------
  404.  
  405.   *   Pa            (Pascal)
  406.       
  407.  
  408. Energy
  409. ------
  410.  
  411.   *   J             (Joule)
  412.   *   cal           (Calorie)
  413.       erg
  414.       Btu           (British thermal unit)
  415.       therm
  416.  
  417.  
  418. Power
  419. -----
  420.  
  421.   *   W             (Watt)
  422.       hp            (horse power)
  423.  
  424.  
  425. Viscosity
  426. ---------
  427.  
  428.       poise
  429.  
  430.  
  431. Temperature
  432. -----------
  433.  
  434.       C             (centigrade)
  435.       F             (Fahrenheit)
  436.       K             (Kelvin)
  437.       R             (Reaumur)
  438.  
  439.  
  440.  
  441.  
  442. NOTE:
  443. -----
  444.  
  445. You should note that the use of temperatures in the weights and measures
  446. converter is different to that in the temperature converter. The weights and
  447. measures converter does NOT convert values of one temperature scale into a
  448. value on another temperature scale, it only converts a change in one scale
  449. to a change in another scale. Thus you can NOT convert 10 °C into °F using
  450. the weights and measures converter, but you CAN convert 10 C° to F° using the
  451. weights and measures converter.
  452.  
  453.  
  454.  
  455.  
  456.                            Copyright Notice
  457.                            ----------------
  458.  
  459. This copyright notice applies to Converter version 1.00.
  460.  
  461. Converter version 1.01 © Copyright 1993 - 1996, Dr. Ian Palmer.
  462.  
  463. This copyright covers the code and any associated data of the above program
  464. with the given version number.
  465.  
  466. In this document the term `program' covers both the program code and any
  467. associated data.
  468.  
  469. The author reserves the right to take action against anyone, or company, who
  470. acts in such a way as to break the conditions specified in the document.
  471.  
  472.  
  473.                              Distribution
  474.                              ------------
  475.  
  476. Permission is hereby given to allow anyone to distribute the afore 
  477. mentioned program, as long as the following conditions are 
  478. adhered to :
  479.  
  480.   • The program is distributed intact, including this copyright
  481.     notice and all other copyright notices.
  482.  
  483.   • The program may only be distributed in such a way that no
  484.     commercial gain, or advantage, is made through it's distribution.
  485.     Distribution 'costs' may be charged, insofar that these costs are 
  486.     limited to independent courier costs, distribution media and 
  487.     packaging.
  488.  
  489.   • All the terms set out in this document are adhered to.
  490.  
  491.   • The author reserves the right to refuse any individual, or
  492.     company, permission to distribute this program.
  493.  
  494.  
  495.                               Alterations
  496.                               -----------
  497.  
  498. You may not alter this program in any way (apart from the !Run file) without
  499. express permission of the author.
  500.  
  501.  
  502.                                 Warranty
  503.                                 --------
  504.  
  505. This program is supplied "as is", without express or implied warranty. 
  506. No representations are made about the suitability of this software for
  507. any purpose.
  508.  
  509.  
  510.                           Contacting the author
  511.                           ---------------------
  512.  
  513.     Snail-mail : Dr. Ian Palmer
  514.                  40, Birch Crescent
  515.                  Aylesford
  516.                  Kent.  ME20 7QE.
  517.                  England.
  518.  
  519.     E-mail     : ian_palmer@ilink.demon.co.uk
  520.  
  521.  
  522. -------------------------------------------------------------------
  523. --------         This document may not be altered         ---------
  524. -------------------------------------------------------------------
  525.